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Errata Overview 

This document clarifies namespace concepts. The concepts of active and inactive namespace IDs 
at a controller level are clarified. The ECN introduces the concept of allocated and unallocated 
namespace IDs at an NVM subsystem level to indicate whether a namespace exists. 
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Revision History 


Revision Date 

Change Description 

2/3/2015 

Draft material to clarify the namespace concepts. 

2/25/2015 

Added concept of full/empty NSID at NVM subsystem level. 

3/4/2015 

Used allocated/unallocated NSID to specify whether a namespace exists. 
Other changes based on 2/26 discussion. 

3/7/2015 

Updated the definition of namespace identifier and the Identify data 
structure that specifies the CNS based operations. 

4/8/2015 

Updates based on discussion at 3/12 meeting. Added picture to clarify how 
NSID Types relate. 

4/13/2015 

Accepted red-lines and made further updates based on reflector discussion. 

4/14/2015 

Incorporated proposed changes from Naren, Jonathan, John, and Lee. 

4/17/2015 

Added that NSID FFFFFFFFh is a broadcast value that is used to specify all 
namespaces. Clarified recommendation that NSIDs should not be changed. 

6/3/2015 

Ratified. 


Description of Specification Changes 


Modify section 6.1 as shown below: 

6.1 Namespaces 

A namespace is a collection of logical blocks that range from 0 to the capacity of the namespace - 1. The 
numb e r of poss i b le nam e spac e s pr e s e nt i s r e port e d i n th e I d e nt i fy Contro lle r data structur e . A namespace ID 
(NSID) is an identifier used by a controller to provide access to a namespace. 

Valid NSIDs are the range of possible NSIDs that correspond to a namespace that may exist in the NVM 
subsystem. Any NSID is valid, except if it is zero or greater than the Number of Namespaces field reported in 
the Identify Controller data structure. NSID FFFFFFFFh is a broadcast value that is used to specify all 
namespaces. An invalid NSID is any value that is not a valid NSID or the broadcast value. 

Active NSIDs are valid NSIDs that are attached to the specific controller. Valid NSIDs that are not attached to 
the specific controller are called inactive. An active NSID becomes inactive when the associated namespace 
is detached from the specific controller or is deleted. 

Allocated NSIDs are valid NSIDs that refer to namespaces that currently exist within an NVM subsystem. An 
allocated NSID may not be attached to any controller. An allocated NSID shall be attached to a controller 
before host software may submit I/O commands for that namespace on that controller. An allocated NSID 
becomes unallocated when the associated namespace is deleted. 

Unless otherwise noted, specifying an inactive namespace ID in a command that uses the namespace ID 
shall cause the controller to abort the command with status Invalid Field in Command. Specifying an invalid 
NSID in a command that uses the NSID field shall cause the controller to abort the command with status 
Invalid Namespace or Format. 

The following table summarizes the valid NSID types. Figure TBD visually shows the NSID types and how 
they relate. 


Valid NSID Type 

The associated namespace 

Active 

is attached to this controller 

Inactive 

is not attached to this controller 
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Allocated 

exists in the NVM subsystem 

Unallocated 

does not exist in the NVM subsystem 


Figure TBD: NSID Types 


NSID 


0 1 


NN NN+1 


FFFFFFFFh 



Broadcast Value 



If Namespace Management is supported then Namespace IDs shall be unique within the NVM subsystem 
(e.g., namespace ID of 3 shall refer to the same physical namespace regardless of the accessing controller). 

If Namespace Management is not supported then Namespace IDs for private namespaces are not required to 
be unique. 

The Identify command may be used to determine the active NSIDs for a controller and the allocated NSIDs in 
the NVM subsystem. 

To determine the active NSIDs for a particular controller, the host may follow either of the following methods: 

1. Issue Identify with the CNS field set to OOh for each valid NSID (based on the Number of 
Namespaces value in Identify Controller). If a non-zero data structure is returned for a particular 
NSID, then that is an active NSID. 

2. Issue Identify with a CNS field set to 02h to retrieve a list of up to 1024 active NSIDs. If there are 
more than 1024 active NSIDs, continue to issue Identify with a CNS field set to 02h until all active 
NSIDs are retrieved. 

To determine the allocated NSIDs in the NVM subsystem, the host may Issue Identify with the CNS field set 
to 10h to retrieve a list of up to 1024 allocated NSIDs. If there are more than 1024 allocated NSIDs, continue 
to issue Identify with a CNS field set to 10h until all allocated NSIDs are retrieved. 

<INSERT BLANK LINE> 

Un le ss oth e rw i s e not e d, sp e c i fy i ng an i nact i v e nam e spac e I D i n a command that us e s th e nam e spac e I D 

sha ll caus e th e contro lle r to abort th e command w i th status I nva li d F iel d i n Command. Sp e c i fy i ng an i nva li d 

nam e spac e I D i n a command that us e s th e nam e spac e I D sha ll caus e th e contro lle r to abort th e command 
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w i th status I nva li d Nam e spac e or Format. Namespace IDs may change across power off conditions or due to 
namespace management. However, it is recommended that namespace identifiers remain static in order to 
avoid issues with EFI or OSes. OS dr i v e rs fast d i scov e ry proc e ss e s. 

The Namespace Size field in the Identify Namespace data structure defines the total size of the namespace in 
logical blocks (LBA 0 through n-1). The Namespace Utilization field in the Identify Namespace data structure 
defines the number of logical blocks currently allocated in the namespace. The Namespace Capacity field in 
the Identify data structure defines the maximum number of logical blocks that may be allocated at one time as 
part of the namespace in a thin provisioning usage model. The following relationship holds: Namespace Size 
>= Namespace Capacity >= Namespace Utilization. 

A namespace may or may not have a relationship to a Submission Queue; this relationship is determined by 
the host software implementation. The controller shall support access to any valid namespace from any I/O 
Submission Queue. 


Modify section 1.6.18 as shown below: 

1.6.18 Namespace ID (NSID) 

An identifier used by a controller to provide access to a namespace. Refer to section 6.1 for the definitions of 
valid NSID, invalid NSID, active NSID, inactive NSID, allocated NSID, and unallocated NSID. 

Th e NS I D va l u e of FFFFFFFFh i s us e d to i nd i cat e a ll nam e spac e s. An i nva li d nam e spac e I D i s a nam e spac e 

I D whos e va l u e i s z e ro or whos e va l u e i s gr e at e r than th e va l u e r e port e d by th e Numb e r of Nam e spac e s (NN) 

f iel d i n th e I d e nt i fy Contro lle r data structur e . A ll oth e r nam e spac e I Ds ar e va li d. A va li d nam e spac e I D that 

maps to an attach e d nam e spac e i s an act i v e nam e spac e I D. A nam e spac e sha ll b e attach e d to a contro lle r 

b e for e host softwar e may subm i t I /O commands for that nam e spac e . A va li d nam e spac e I D that do e s not 

map to an attach e d nam e spac e i s an i nact i v e nam e spac e I D. A va li d nam e spac e I D b e com e s i nact i v e wh e n 

th e assoc i at e d nam e spac e i s d e tach e d or d ele t e d. 

I f Nam e spac e Manag e m e nt i s support e d th e n Nam e spac e I Ds sha ll b e un i qu e w i th i n th e NVM subsyst e m 

( e .g., nam e spac e I D of 3 sha ll r e f e r to th e sam e phys i ca l nam e spac e r e gard le ss of th e acc e ss i ng contro lle r). 

I f Nam e spac e Manag e m e nt i s not support e d th e n Nam e spac e I Ds for pr i vat e nam e spac e s ar e not r e qu i r e d to 

b e un i qu e . 
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Modify Figure 86 as shown below: 


Figure 86: Identify - Data Structure Returned 


CNS 

Value 

Definition 

OOh 

The Identify Namespace data structure is returned to the host for the namespace specified in 
the Namespace Identifier (CDW1 .NSID) field if it is an active NSID the namespace is attached 
to this controller. If the specified namespace is not an active an inactive NSID namespace ID, 
then the controller returns a zero filled data structure. 

If the controller supports Namespace Management and CDW1.NSID is set to FFFFFFFFh, 
the controller returns an Identify Namespace data structure that specifies capabilities that are 
common across namespaces for this controller. 

01 h 

The Identify Controller data structure is returned to the host for this controller. 

02h 

A list of 1024 namespace IDs is returned containing active NSIDs namespace IDs attached 
to this controller in increasing order that are greater than the value specified in the 

Namespace Identifier (CDW1 .NSID) field of the command. The data structure returned is a 
Namespace List (refer to section 4.8). 

Controllers that support specification revision 1.1 or later shall support this capability. 

03h - OFh 

Reserved 

Namespace Management 

10h 

A list of up to 1024 namespace IDs is returned to the host containing allocated NSIDs 

than the value specified in the Namespace Identifier (CDW1 .NSID) field. The namespaces 
may or may not be attached to controller(s). 

11 h 

The Identify Namespace data structure is returned to the host for the namespace specified in 
the Namespace Identifier (CDW1 .NSID) field if it is an allocated NSID. The namespace may 
or may not be attached to this controller. If the specified namespace is an unallocated NSID 
invalid then the controller returns a zero filled data structure. If the specified namespace is 
an invalid NSID invalid then the controller shall fail the command with a status code of 

Invalid Namespace or Format. 

12h 

A Controller List of up to 2047 controller identifiers is returned containing a controller identifier 
greater than or equal to the value specified in the Controller Identifier (CDW10.CNTID) field. 
The list contains controller identifiers that are attached to the namespace specified in the 
Namespace Identifier (CDW1.NSID) field. 

13h 

A Controller List of up to 2047 controller identifiers is returned containing a controller identifier 
greater than or equal to the value specified in the Controller Identifier (CDW10.CNTID) field. 
The list contains controller identifiers in the NVM subsystem that may or may not be attached 
to namespace(s). 

14h — 1Fh 

Reserved 

Future Definition 

20h - FFh Reserved 


Modify Figure 92 (Identify Namespace) as shown below: 


15:8 

M 

Namespace Capacity (NCAP): This field indicates the maximum number of logical blocks that 
may be allocated in the namespace at any point in time. The number of logical blocks is based 
on the formatted LBA size. This field is undefined prior to the namespace being formatted. This 
field is used in the case of thin provisioning and reports a value that is smaller than or equal to 
the Namespace Size. Spare LBAs are not reported as part of this field. 

namespace ID. 

A logical block is allocated when it is written with a Write or Write Uncorrectable command. A 
logical block may be deallocated using the Dataset Management command. 
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Modify the first paragraph of section 5.12 (Namespace Attachment) as shown below: 

The Namespace Attachment command is used to attach and detach controllers from a namespace. The 
attach and detach operations are persistent across all reset events. 


Modify the first paragraph of section 5.13 (Namespace Management) as shown below: 

The Namespace Management command is used to manage namespaces, including create and delete 
operations. Note: The controller continues to execute commands submitted to I/O Submission Queues while 
this operation is in progress. 
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